home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / carib28.zip / CARIB.DOC < prev    next >
Text File  |  1993-04-19  |  10KB  |  219 lines

  1.             * * * * * * * * * * * * * * * * * * * * * * * * *
  2.             *                                               *
  3.             *             CARIBBEAN CONTRABAND              *
  4.             *                 VERSION  2.8                  *
  5.             *                   12/15/92                    *
  6.             *                                               * 
  7.             *                  Written By:                  *
  8.             *                 Michael Goetz                 *
  9.             *                                               *
  10.             *            Copyright (c) 1991, 1992           *
  11.             *               All Rights Reserved             *
  12.             *                                               *
  13.             *                 SUPPORT  BBS:                 *
  14.             *                The CAVERNS EBBS               *
  15.             *                 (407) 521-9886                *
  16.             *          PCB 14.5 * HST D/S 1200-38,400       *
  17.             *                                               *
  18.             * * * * * * * * * * * * * * * * * * * * * * * * * 
  19.  
  20. INTRODUCTION
  21. ------------
  22.  Caribbean Contraband is a fun and addictive game DOOR for Bulletin
  23.  Board Systems.  Playing the game is easy to learn.  As you travel the
  24.  Caribbean, you'll test your skills in buying and selling Contraband.  
  25.  The strategy is knowing when to buy particular items and when to sell 
  26.  them, while avoiding various obstacles that you'll meet along the way.  
  27.  
  28. FEATURES
  29. --------
  30.  - ANSI color and Mono screens
  31.  - Supports up to 340k bps
  32.  - Supports most BBS Software
  33.  - Supports non-standard port & IRQ
  34.  - Supports FOSSIL drivers
  35.  - Easy installation and maintainance
  36.  - Creates graphic/non-graphic bulletin (Reg. Req.)
  37.  - Automatically maintained Bulletin/Top Score
  38.                               
  39. INSTALLATION
  40. ------------
  41.  Installation is very easy.  Create a directory to hold all CARIBBEAN
  42.  CONTRABAND files and unzip CARIBxx.ZIP into this directory.
  43.  
  44.  Files should consist of:
  45.   CARIB28.EXE ..... Main program file
  46.   CCSETUP.EXE ..... Setup utility to create configuration file (CARIB.CFG)
  47.   CARIB.INS ....... On-line Instruction file
  48.   CARIB.USR ....... User file (Must have this file to operate game!)
  49.   CARIB  .......... Sample Batch file (modify as needed)
  50.   CARIB.CFG ....... Sample Configuration file (modify as needed)
  51.   CCKILL.EXE ...... Bulletin - Top Score maintainance file
  52.   CARIB.DOC ....... You're reading it!
  53.   REGISTER.FRM .... Please use it... I need the money!!!  :-)
  54.   UPGRADE.TXT ..... IMPORTANT: Read this if upgrading from previous version!
  55.   WHATSNEW.TXT .... History file
  56.   FILE_ID.DIZ ..... Description file for PCBoard 14.5a and others!
  57.  
  58.  Change to the directory you created and run CCSETUP.EXE and enter the
  59.  data in the fields as applicable to your system.  The first line will 
  60.  ask for the full path and filename of your BBS information file.  For
  61.  example: C:\PCB\PCBOARD.SYS.  Caribbean Contraband uses this filename 
  62.  to determine the BBS software which is being used as follows:
  63.  
  64.  PCBOARD.SYS   (PCBoard)
  65.  CALLINFO.BBS  (Wildcat!)
  66.  DOOR.SYS      (GAP and other systems using std. DOOR.SYS)
  67.  DORINFOx.DEF  (QuickBBS/Remote Access/RBBS)
  68.  
  69.  NOTE: DO NOT EXCEED 35 CHARACTERS FOR THE SYSTEM PATH!!
  70.  
  71.  Line <4> will ask for the path & name for the non-graphics Bulletin
  72.  file that will be created after each completed game.  The Bulletin
  73.  will only be created with the REGISTERED VERSION.   Until registered,
  74.  place "NONE" in this field.
  75.  
  76.  Line <5> will ask for the path and name for the Graphics Bulletin
  77.  file that will be created after each completed game.  The Bulletin
  78.  will only be crated with the REGISTERED VERSION.  Until registered,
  79.  place "NONE" in this field.
  80.  
  81.  Line <6> will ask for the registration code number.  Until the program
  82.  is registered, place 0000 in the Registration field.
  83.  
  84.  Line <7> will ask for the number of moves per game (max. of 50).  I
  85.  recommend 30 moves as being a good starting number.   This takes an
  86.  average player approximately 5 minutes to complete a game.  Keep in
  87.  mind that a player's score is *not* recorded to the Top Score file
  88.  unless he/she completes a game. NOTE: UNREGISTERED VERSION forces
  89.  30 moves. Place 30 in this field until program is registered.
  90.  
  91.  Line <8> asks for the number of games allowed each user per day
  92.  (max. of 10).  NOTE: UNREGISTERED VERSION forces two (2) games.
  93.  place 2 in this field until program is registered.
  94.  
  95.  Line <9> will ask for the maximum number of Top Scores to write to
  96.  the Top Score file and Bulletins (max. of 50).  Enter 50 until
  97.  registered.
  98.  
  99.  NOTE: ALL FIELDS *MUST* BE FILLED IN OR PROGRAM FAILURE WILL OCCUR !!
  100.  
  101.  After entering all of the information, exit CCSETUP.EXE by pressing
  102.  <S>ave....  This will create the CARIB.CFG file and place it in the
  103.  current directory.  
  104.  
  105.  Consult your BBS Software manual on how to create a DOOR batch file,
  106.  and modify the CARIB! batch file supplied.  An example batch file for
  107.  PCBoard:
  108.  
  109.   @Echo off
  110.   C:
  111.   CD\PCB\DOORS\CARIB
  112.   CARIB28 CARIB.CFG     <---- This is the command line for calling
  113.   C:                        Caribbean Contraband.  MUST BE THE SAME
  114.   CD\PCB                    or program failure will occur !!  For
  115.   BOARD.BAT                 non-standard port address and IRQ, see
  116.                             NOTE below!
  117.  
  118.  NOTE: If you need to specify a non-standard port address and IRQ,
  119.        then you will need to add this information to the BATCH file
  120.        calling CARIBBEAN CONTRABAND. The syntax is PORT:AAAA:X where
  121.        AAAA is the base address and X is the IRQ. An example batch
  122.        file:
  123.              @echo off
  124.              c:
  125.              cd\pcb\doors\carib
  126.              carib28 carib.cfg PORT:03E8:5  <---- NEW COMMAND LINE!
  127.              c:
  128.              cd\pcb
  129.              board.bat
  130.  
  131.  
  132.        CARIBBEAN CONTRABAND will also support the use of FOSSIL drivers.
  133.        The syntax for a FOSSIL driver is: PORT:F:P.  The 'F' tells the
  134.        door to use a Fossil driver for it's communications, and the 
  135.        'P' following it tells it which port to use for the Fossil.
  136.        Example: PORT:F:1 tells it to use a Fossil driver for port 1.
  137.  
  138.  CCKILL.EXE is a utility that can be called from the EVENT.SYS (or the
  139.  equivalent for your BBS Software) that will automatically, on the 1st
  140.  of each month, create/update the "Last Month's Top Smuggler" (which is 
  141.  displayed on the Top Score screen and the Bulletin after registering). 
  142.  It will also delete the previous month's Top Scores (CARIB.SCR), making 
  143.  Caribbean Contraband virtually maintainance free!  It will only execute
  144.  if run on the 1st of the month.  
  145.  
  146.  NOTE: CCKILL.EXE can be forced to run by entering "CCKILL /u" if desired.
  147.  WARNING: This will delete the Top Score file !!
  148.  
  149. MULTI-NODE SYSTEMS
  150. ------------------
  151.  When running more than one node, be sure to have a different configuration
  152.  for each node, and create a batch file for each node.  The configuration
  153.  file for each node can be created easily by entering at the dos prompt:
  154.  CCSETUP CARIBx.CFG, where 'x' is the node number.   This will cause
  155.  CCSETUP.EXE to create a configuration file under the name entered rather
  156.  than the default (CARIB.CFG).
  157.  
  158.  Example CARIB2.BAT file:           Example CARIB2.CFG:
  159.  ------------------------           -------------------
  160.  @echo off                         <1> c:\pcb2\pcboard.sys  <--- path to
  161.  c:                                <2> The Caverns EBBS          node 2
  162.  cd\pcb\doors\carib                <3> Michael Goetz             system
  163.  carib28 carib2.cfg                    ....and so on             file.
  164.  c:
  165.  cd\pcb2
  166.  board2.bat
  167.  
  168. REGISTRATION !!
  169. ---------------
  170.  Registration is required if you choose to continue using this DOOR 
  171.  program after a 3 or 4 week evaluation period.  When registered, the
  172.  "[UNREGISTERED EVALUATION COPY]" line will be replaced with the name
  173.  of your BBS followed by the SysOp name as well as the removal of the 
  174.  delay built into the opening and closing screens.  Registration will
  175.  also allow the creation of a colorful graphic Top Score Bulletin which 
  176.  is updated after each completed game.  The total number of Top Scores
  177.  posted can also be specified in the configuration file (maximum of 50)
  178.  as well as the amount of MOVES per game (maximum of 50) and the amount
  179.  of GAMES per day.  PLEASE SUPPORT SHAREWARE!!!
  180.  
  181.  To register your copy of CARIBBEAN CONTRABAND, please fill out the 
  182.  supplied registration form (REGISTER.FRM) and mail it along with a
  183.  small donation of $20.00 or $25.00 (check or Money Order) payable to
  184.  Michael Goetz, address on the form.   Please be sure you enter the
  185.  information on the form as it appears in the CARIB.CFG file.  Your
  186.  registration code is based upon this information!
  187.  
  188.  After receiving your registration form, I will pre-register you on the
  189.  Caverns EBBS.  You will then be able to call the CAVERNS and receive
  190.  your registration code. Please allow at least 7 days prior to calling.
  191.  If you prefer, I will mail your registration code if you supply a self-
  192.  addressed stamped envelope.  
  193.    
  194. APPRECIATION
  195. ------------
  196.  I would like to thank Steve Page, SysOp of the SpeakEasy BBS, and Jim
  197.  Murphey, SysOp of the Coffee Shop BBS, for beta testing the program. 
  198.  Their assistance in the development of Caribbean Contraband is sincerely
  199.  appreciated.
  200.  
  201. SUPPORT
  202. -------
  203.  If you have any questions concerning the setup or operation of CARIBBEAN
  204.  CONTRABAND, I can be reached via email thru PCRelay's (RIME) BBS-DOORS
  205.  conference or at The Caverns EBBS, Majic Software's support BBS.
  206.  
  207. LEGALITIES
  208. ----------
  209.  THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  210.  WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  211.  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  212.  IN NO EVENT SHALL THE AUTHOR OR ANYONE INVOLVED WITH THE CREATION AND PRO-
  213.  DUCTION OF THIS PRODUCT BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR
  214.  CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OF THIS PROGRAM.  YOUR USE OF 
  215.  THIS PROGRAM CONSTITUTES YOUR AGREEMENT TO THIS DISCLAIMER AND YOUR RELEASE
  216.  OF THE AUTHOR FROM ANY FORM OF LIABILITY OR LITIGATION.
  217.  
  218.                                 - END - 
  219.